home *** CD-ROM | disk | FTP | other *** search
/ BMUG PD-ROM A / PD-ROM A.iso / Utility / cdevs and INITs / Escapade 1.3.2 / About Escapade 1.3.2 next >
Encoding:
Text File  |  1991-12-27  |  14.9 KB  |  306 lines  |  [TEXT/ttxt]
  1. ______________________________________________________________________________________________
  2.  
  3.  
  4.  
  5.  
  6. Documentation and release notes
  7.  
  8. Version 1.3.2 — 26 October 1991
  9.  
  10. Written and Copyright © 1990-1991 by Christopher R. Wysocki.
  11.  
  12. All rights reserved.  Commercial distribution restricted.
  13.  
  14. ______________________________________________________________________________________________
  15.  
  16.  
  17. Distribution Policy
  18.  
  19.  
  20. Escapade is provided free of charge to all Macintosh users.  It may be distributed freely, provided 
  21. that both the software and this documentation are always distributed together, in whole and 
  22. unchanged.  Escapade may not be sold or offered for sale, or included with another software 
  23. product offered for sale, except with the express written permission of the author.  Companies that 
  24. distribute public domain/freeware/shareware software for profit are expressly prohibited from 
  25. distributing Escapade — I did not write Escapade so that someone else could make a profit off of it.  
  26. This restriction does not apply to bulletin boards, commercial on-line services such as America 
  27. Online, CompuServe and GEnie, and non-profit Macintosh user groups which hold regularly 
  28. scheduled public meetings.
  29.  
  30.  
  31. Introduction
  32.  
  33.  
  34. Escapade is a Control Panel (“cdev”) designed for people who prefer to keep their hands on the 
  35. keyboard while using a Macintosh.  Escapade provides:
  36.  
  37.  
  38. • Keyboard shortcuts for buttons and check boxes in dialogs.
  39.  
  40. With Escapade, you can select the Cancel button in a dialog box by pressing Escape, -Period 
  41. or -Delete.  You can also select any button or check box by pressing the first letter of the 
  42. control’s title.  In addition, with Escapade you can move through all the buttons and check 
  43. boxes in a dialog box and “press” any of them via the keyboard.
  44.  
  45.  
  46. • Support for the standard -key equivalents for Cut, Copy, Paste and Select All.
  47.  
  48. In dialog boxes with editable text fields, Escapade allows you to use the standard -key 
  49. equivalents (X, C, V and A) for Cut, Copy, Paste and Select All, respectively.  If you have 
  50. an extended keyboard (one with a row of function keys across the top), Escapade will 
  51. recognize and handle F2, F3 and F4 as Cut, Copy and Paste, respectively.
  52.  
  53. • Support for “smart” quotes in dialog boxes.
  54.  
  55. When you enter a regular quotation mark into a text entry field in a dialog, Escapade can 
  56. automatically convert it to the appropriate “curly” quotation mark, if so desired.
  57.  
  58.  
  59. • Support for the standard text-editing cursor in dialog boxes.
  60.  
  61. With Escapade, the cursor will automatically change to the standard text-editing (“i-beam”) 
  62. cursor when the cursor is positioned over an editable text field, enabling you to accurately 
  63. select text and position the insertion point.
  64.  
  65.  
  66.  
  67. Installing Escapade
  68.  
  69.  
  70. Escapade requires System version 4.2 or later and at least the 128k ROMs (Macintosh 512ke/Plus 
  71. or later).  To install Escapade, simply drag it to the System Folder on your startup disk (usually 
  72. your hard disk.)
  73.  
  74.  
  75. Escapade has been tested and is fully compatible with System 7.0.  If you are running System 7.0, 
  76. Escapade should be placed in the Control Panels folder within the System Folder.  If you drag the 
  77. Escapade icon to the System Folder icon, you will be presented with an alert asking if you want to 
  78. place Escapade in the Control Panels folder; you should click the OK button in response to this 
  79. alert.
  80.  
  81.  
  82.  
  83. Using and Configuring Escapade
  84.  
  85.  
  86. You can configure Escapade to suit your particular preferences via its control panel.  To do this, first 
  87. select either the Control Panel (if you are running System 6.0) or the Controls Panels folder (if you 
  88. are running System 7.0) from the  menu.  If you are running System 6.0, when the Control Panel 
  89. window appears, scroll through the icon list until the Escapade icon is visible.  Clicking on the 
  90. Escapade icon will bring up the Escapade panel.  With System 7.0, double-clicking on the Escapade 
  91. icon in the Control Panels folder will bring up the Escapade control panel.
  92.  
  93.  
  94. The “On” and “Off” buttons in the lower left corner allow you to enable or disable Escapade.  If you 
  95. should turn Escapade off, please remember that it is not turned back on unless you explicitly do so.
  96.  
  97.  
  98. The check boxes under “Cancel is” allow you to specify which key(s) among Escape, -Period, and 
  99. -Delete are equivalent to a click on the Cancel button of a dialog or alert box.  This provides you 
  100. with an easy, consistent way to select the Cancel button, in the same manner that Return or Enter 
  101. can be used to select the OK button.
  102.  
  103.  
  104. Under “Move with”, you can select which pair(s) of keys to use to move through buttons or check 
  105. boxes in a dialog or alert box.  You may choose among -Up Arrow/-Down Arrow, -Right Arrow/-
  106. Left Arrow, and -Tab/-Shift-Tab.  Pressing the first key in one of these pairs will move you forward 
  107. one button/check box, while pressing the second key in a pair will move you backward one 
  108. button/check box.
  109.  
  110.  
  111. When the desired button is blinking, you can press any of the key combinations that are checked 
  112. under “Click with” to “press” the button.  This has the same effect as clicking the highlighted  
  113. button or check box with the mouse button.
  114.  
  115.  
  116. If “First character selects button” is checked, you can press the key corresponding to the first letter 
  117. of a pushbutton’s title in conjunction with the  key and Escapade will “press” the appropriate button 
  118. for you.  If a dialog has more than one button whose title begins with a particular character, 
  119. pressing that character the first time will highlight one of the buttons.  Subsequent presses of the 
  120. same key will cycle you through the buttons beginning with that character.  When the desired button 
  121. is highlighted, press any of the “Click with” key combinations and Escapade will “press” the 
  122. button.  For example, suppose that a dialog box contains four pushbuttons—“Down”, “Duplicate”, 
  123. “Delete” and “Done”  You wish to select “Duplicate”, so you press -D once and the “Down” button 
  124. begins to blink.  Since this is not the button that you want, you press -D a second time.  The 
  125. “Down” stops blinking and “Duplicate” starts to blink.  “Duplicate” is the button that you want, so 
  126. you press -Space (assuming that -Space is a “Click with” key combination) and the button is 
  127. selected.  (Please note that the exact order in which buttons are highlighted depends on the layout of 
  128. the particular dialog box and therefore cannot be predicted.  This also applies to the selection of 
  129. buttons and check boxes via -Tab/-arrow key.)
  130.  
  131.  
  132. Both “ key is optional” and “Select check boxes and radio buttons” apply only if “First character 
  133. selects button” is selected.  If “ key is optional” is checked, you do not need to hold down the  key 
  134. to “press” a button in the manner described in the preceding paragraph.  This applies only if there 
  135. are no text entry fields in the dialog box; if any text entry fields are present, the  key is mandatory 
  136. regardless of this setting.  Also, please note that this option applies only to the selection of buttons 
  137. as described in the preceding paragraph; it does not apply to the “Select with” or “Click with” key 
  138. combinations.  “Select check boxes and radio buttons”, if enabled, allows you to select radio button 
  139. and check boxes, in addition to pushbuttons, by pressing the first character of the control’s label.
  140.  
  141. If “Cancel key selects OK if no other buttons” is checked and there is only a single button in a 
  142. dialog or alert, pressing any Cancel key (Escape, -Period or -Delete) will select the lone button. 
  143.  
  144. The remaining options pertain to dialogs with text entry fields.  “Show i-beam cursor” determines 
  145. whether or not the cursor will be changed to the standard text-selection cursor when it is positioned 
  146. over a text entry field.  If “Use “smart” quotes” is checked, Escapade will convert any quotation 
  147. marks that you type to the appropriate “curly” quotation mark.  Should you wish to enter a standard 
  148. quotation mark (" or ') when this option is checked, hold down the  key when you press the 
  149. quotation mark key.
  150.  
  151.  
  152. If selected, “Enable -X/C/V” allows you to use the standard -key equivalents for Cut, Copy and 
  153. Paste.  Similarly, if “Enable -A” is checked, you can press -A to select all of the text that has been 
  154. entered in the field.  If you have an extended keyboard, the “Enable F2/F3/F4” option, if checked, 
  155. allows you to use these keys in a dialog box for Cut, Copy and Paste, respectively.
  156.  
  157.  
  158. Clicking on the “Highlight Delay…” button will present you with a dialog box that allows you to set 
  159. the duration for which a selected button is highlighted after it is “pressed.”  Select “None” if you do 
  160. not wish to have Escapade blink a button after you select it using the keyboard.  Similarly, clicking 
  161. on the “Blinking Rate…” button allows you to adjust the rate at which a blinking button or check 
  162. box blinks.  The three rates correspond to the blinking rates available for the text insertion point in 
  163. the standard General control panel.
  164.  
  165.  
  166. The setting of “Show icon at startup” determines whether or not the Escapade icon is displayed at 
  167. the bottom of the screen when the Macintosh is powered up or restarted.
  168.  
  169.  
  170.  
  171. Configuring Escapade for Specific Applications
  172.  
  173.  
  174. If you find that Escapade conflicts with the normal operation of a particular application,  Escapade 
  175. permits you to set up a custom Escapade configuration for the application.  To do this, select “Add 
  176. Application…” from the “Settings” pop-up menu at the top of the Escapade pane in the Control 
  177. Panel window.  You will be presented with a standard “open” dialog box, which you should use 
  178. find the application for which you wish to set up a custom configuration.  After you select the 
  179. “Add” button, you will be returned to the Control Panel, where you can then select or deselect the 
  180. appropriate options for the application.  To disable Escapade completely within the application, 
  181. uncheck all of the check boxes; do not select the “Off” button, as this will disable Escapade in all 
  182. applications.
  183.  
  184.  
  185. After you have added one or more application configurations, the “Settings” pop-up menu can be 
  186. used to select a particular application configuration so that the settings for the application can be 
  187. changed.  If a custom configuration is not present for an application, Escapade uses the settings that 
  188. are displayed when “Default” is selected from the pop-up menu.
  189.  
  190.  
  191. If you should wish to remove a custom Escapade configuration that you have added, select 
  192. “Remove Application…” from the pop-up menu.  You will be presented with dialog box containing 
  193. a list of the applications in the “Settings” menu; to remove an application, select its name from the 
  194. list and click OK.
  195.  
  196.  
  197.  
  198. Known Problems and Incompatibilities
  199.  
  200.  
  201. Unfortunately, Escapade is not compatible with all Macintosh applications.  Certain applications 
  202. handle dialog boxes in a manner that circumvents Escapade.  Two popular applications that do not 
  203. work with Escapade are Microsoft Word and Excel, and there are probably others.  (Please note that 
  204. using Escapade along with such applications will not cause any problems; the features of Escapade 
  205. will simply not be available.  This should not be a major concern in either Word or Excel, as both 
  206. offer keyboard shortcuts that are similar to those provided by Escapade.)
  207.  
  208.  
  209.  
  210. Tips, Tricks and Shortcuts
  211.  
  212.  
  213. Assuming that it is located in the System Folder (or in the Control Panels folder, with System 7.0) 
  214. of your startup disk, Escapade will be installed automatically at startup.  If for some reason you do 
  215. not wish to install Escapade, you may hold down either the Shift key or the mouse button while 
  216. your Macintosh is starting up.  However, if Escapade is not installed at startup, it will be 
  217. unavailable until the next time that you restart your Macintosh.  If you wish to disable Escapade 
  218. temporarily after it has been installed, you may turn it off via its control panel.
  219.  
  220.  
  221. If you find that Escapade conflicts with another dialog enhancement utility (such as Boomerang), 
  222. you can use the Shift key to instruct Escapade to ignore a particular  key combination.  For 
  223. example, if “-A is Select All” is enabled, pressing -A in a “Save As” dialog box will select the entire 
  224. file name.  If you also use Boomerang and have set -A to move you to a particular folder, you will 
  225. find that you won’t be able to use this key combination, since Escapade will treat the -A as a “Select 
  226. All”.  The solution here is to hold down the Shift key while pressing -A, so that Escapade will 
  227. ignore the -A and pass it along for Boomerang to handle.
  228.  
  229. Differences From Previous Versions
  230.  
  231.  
  232. Escapade version 1.3.2 fixes several minor bugs that were present in previous versions; 
  233. specifically:
  234.  
  235.  
  236. • Escapade no longer crashes at startup when running in 32-bit mode with more than 8 megs of 
  237. RAM. (Fixed in version 1.3.2)
  238.  
  239.  
  240. • Escapade now works properly with the Teleport/Fax software from Global Village 
  241. Communications.  (Fixed in version 1.3.1)
  242.  
  243.  
  244. • The Escapade icon now shows up in a QuicKeys 2 QuickPanel.  (Fixed in version 1.3.1)
  245.  
  246.  
  247. • The labels on the “-Return” and “-Enter” check boxes in the Escapade control panel are now 
  248. correct; they were incorrectly reversed in previous versions.  (Fixed in version 1.3.1)
  249.  
  250.  
  251. • Escapade should now function in 32-bit mode under System 7.  (Fixed in version 1.3)
  252.  
  253.  
  254. • Escapade will no longer arbitrarily select check boxes and radio buttons when you press the first 
  255. letter of the control’s title in conjunction with the  key.  (Fixed in version 1.3)
  256.  
  257.  
  258. • The Escapade Control Panel device (cdev) will no longer crash at random when the Control Panel 
  259. is redrawn while in the background.  (Fixed in version 1.2.2)
  260.  
  261.  
  262. • You can now enter a space in an editable text field if -Space is selected as a “Click with” key 
  263. combination and “ key is optional” is also selected.  (Fixed in version 1.2.2)
  264.  
  265.  
  266. • If a -key combination is pressed and there are more than two buttons whose titles begins with the 
  267. character pressed, Escapade will now properly cycle through all the buttons.  (Fixed in version 
  268. 1.2.1)
  269.  
  270.  
  271. • You no longer need to have “-X/C/V are Cut/Copy/Paste” enabled in order to have “-A is Select 
  272. All” work properly.  (Fixed in version 1.2.1)
  273.  
  274.  
  275. • If you Cut or Copy in a dialog (via -X or -C), Escapade will no longer dispose of the contents of 
  276. the Clipboard if a range of text is not selected.  (Fixed in version 1.2.1)
  277.  
  278.  
  279. • If a -key combination is pressed and there is more than one button whose title begins with the 
  280. character pressed, Escapade will no longer arbitrarily “press” one of them.  (Fixed in version 1.2)
  281.  
  282.  
  283. • If there is an editable text field in a dialog box, Escapade will not blindly select the OK button if 
  284. Return is pressed.  This fixes a reported problem when editing a text QuicKey. (Fixed in version 
  285. 1.1.1)
  286.  
  287.  
  288. • If the first item in a dialog or alert box is not a button, Escapade will no longer cause a system 
  289. error if Enter or Return is pressed.  (Fixed in version 1.1.1)
  290.  
  291.  
  292.  
  293. Comments, suggestions, enhancement requests, bug reports, etc.
  294.  
  295.  
  296. The author welcomes feedback concerning Escapade and can be reached at the following electronic 
  297. addresses:
  298.  
  299.  
  300. America Online:    AFC ChrisW
  301.  
  302. CompuServe:    72010,1140
  303.  
  304. Internet:    72010.1140@compuserve.com
  305.  
  306.